本文介绍如何使用行空板 K10 与 SIoT 通信,并分别用 Mind+ 的 上传模式、MicroPython 积木模式 和 MicroPython 代码模式 完成两个项目:
- 行空板 K10 上传温度数据到 SIoT。
- SIoT 发送控制指令,让行空板 K10 控制 RGB 灯打开或关闭。
为了便于学习,本文将三种编程方式分开编写。建议初学者先完成 上传模式,再对照学习 MicroPython 积木模式 和 MicroPython 代码模式。
行空板 K10 自带温度传感器、屏幕、RGB 灯 and Wi-Fi 能力,很适合用来做“数据上传 + 远程控制”的入门物联网项目。
1. 准备工作
1.1 硬件准备
本教程以使用行空板 K10 的板载温度传感器和板载 RGB 灯为例。
| 硬件 | 用途 | 示例连接 |
|---|---|---|
| 行空板 K10 | 运行程序、连接 SIoT、控制硬件 | 通过 USB 连接电脑 |
| 板载温度传感器 | 采集温度 | 无需外接 (板载) |
| 板载 RGB 灯 | 接收 SIoT 指令后亮灭 | 无需外接 (板载) |
| 电脑 | 运行 Mind+、访问 SIoT 页面 | 与行空板 K10 在同一局域网 |
如果使用的是外接传感器或外接 LED 模块,请根据实际硬件连接修改程序中的引脚和控制逻辑。
1.2软件准备
⚠️ 重要提示(与行空板 M10 的区别):
行空板 M10 拥有独立的 Linux 系统,可以直接在板载系统内运行 SIoT 服务并通过10.1.2.3访问。
而行空板 K10 本身没有运行完整操作系统的能力,因此无法在板子上运行 SIoT 服务。
你必须在本地电脑上运行 SIoT 软件(即在电脑端开启并运行该软件服务)。电脑和行空板 K10 必须连接在同一个 Wi-Fi 局域网下,程序中填写的SIoT 服务器地址应当是电脑的局域网 IP 地址(例如192.168.1.183),而**绝对不能填写 **10.1.2.3****。
开始前请确认:
- 已安装 Mind+。
- 行空板 K10 可以正常连接电脑。
- 已在本地电脑上启动并运行了 SIoT 软件。
- 电脑和行空板 K10 连接在同一个 Wi-Fi 局域网内。
- 电脑浏览器可以正常打开 SIoT Web 管理页面。
- 已根据 Mind+ 提示完成行空板 K10 的 MicroPython 固件烧录(仅 MicroPython 模式需要)。
常用连接参数如下:
| 参数 | 示例值 |
|---|---|
| Wi-Fi 名称 | 你的WiFi名称 |
| Wi-Fi 密码 | 你的WiFi密码 |
| SIoT 服务器地址 | 实际运行 SIoT 的设备 IP |
| MQTT 端口 | 1883 |
| 用户名 | siot |
| 密码 | dfrobot |
如果行空板 K10 与电脑通过 Wi-Fi 接入同一网络,请填写 SIoT 服务器在当前局域网中的实际 IP,例如:192.168.1.183。
1.3 本教程使用的 Topic
| Topic | 通信方向 | 用途 |
|---|---|---|
siot/k10_temp |
行空板 K10 -> SIoT | 上传温度数据 |
siot/k10_led |
SIoT -> 行空板 K10 | 接收 RGB 灯控制指令 |
在 SIoT V2 中,可以在 Web 页面中创建 k10_temp、k10_led 两个主题。创建后,程序中使用完整 Topic:
siot/k10_temp
siot/k10_led
2. 上传模式
上传模式适合在课堂中快速完成图形化程序。程序下载到行空板 K10 后,可以脱离电脑独立运行。
2.1 进入上传模式
打开 Mind+ 后,按下面步骤操作:
- 点击
新建项目。 - 选择
上传模式。 - 点击
扩展。 - 加载以下扩展库:
| 扩展库 | 用途 |
|---|---|
| 行空板 K10 | 控制板载屏幕、传感器和 RGB 灯 |
| Wi-Fi | 用于连接局域网无线网络 |
| MQTT / SIoT | 连接 SIoT 并收发消息 |

- 连接行空板 K10,并确认端口识别正常。

2.2 设置 SIoT 连接
在程序开始后,先完成 Wi-Fi 连接和 MQTT 初始化。
积木参数建议如下:
| 设置项 | 填写内容 |
|---|---|
| WiFi名称 | 你的WiFi名称 |
| WiFi密码 | 你的WiFi密码 |
| 平台 | SIoT V2 |
| 服务器地址 | 实际 SIoT IP |
| 用户名 | siot |
| 密码 | dfrobot |
| 设置WiFi | 设置MQTT |
|---|---|
![]() |
![]() |
参考程序如下:

连接成功后,行空板 K10 屏幕上会出现类似“WIFI连接成功和MQTT连接成功”的提示。

2.3 项目一:上传温度数据到 SIoT
项目效果
行空板 K10 每隔 2 秒读取一次板载温度传感器,并把数据发送到 SIoT:
| 数据 | Topic |
|---|---|
| 温度 | siot/k10_temp |
积木编写步骤
- 在
当程序开始下先连接 Wi-Fi,并初始化、连接 MQTT/SIoT。 - 在屏幕上初始化并显示文字提示 "WIFI已连接"和"MQTT已连接"。
- 在循环中读取板载温度。
- 将读取的温度发布到
siot/k10_temp,建议使用带“保存到数据库”说明的发布积木。 - 在 K10 屏幕上刷新显示当前的温度。
- 等待 2 秒后继续循环。
参考程序如下:

查看上传结果
程序上传并运行后,打开 SIoT Web 页面,进入 siot/k10_temp 的数据管理页面。如果可以看到不断更新的数据,说明温度上传成功。

2.4 项目二:通过 SIoT 控制 RGB 灯
项目效果
在 SIoT Web 页面中向 siot/k10_led 发送指令,行空板 K10 根据指令控制板载 RGB 灯。
| 发送内容 | RGB 灯状态 |
|---|---|
ON |
亮起(例如显示绿色) |
OFF |
关闭 |
积木编写步骤
- 在 MQTT 初始化参数设置里面再订阅一个
siot/k10_led的主题。 - 添加“当 MQTT 接收到消息”事件。
- 在事件中判断接收到的消息主题是否为
siot/k10_led。 - 如果消息内容是
ON,设置板载 RGB 灯显示绿色,屏幕显示 "灯已打开"。 - 如果消息内容是
OFF,关闭板载 RGB 灯,屏幕显示 "灯已关闭"。
参考程序如下:

发送控制指令
打开 SIoT Web 页面,进入 siot/k10_led 主题的数据管理页面。在消息内容中输入 ON,点击发送,RGB 灯应亮起。输入 OFF 并点击发送,RGB 灯应熄灭。

2.5 上传模式综合效果
完成以上两个项目后,可以将它们合并到同一个程序中,使其能够同时完成数据上传和远程控制:

运行效果:

3. MicroPython 积木模式
MicroPython 积木模式结合了图形化拖拽的便利,同时能够显示并生成对应的 MicroPython 源代码,适合中阶学习者。
3.1 进入 MicroPython 积木模式
- 打开 Mind+,新建项目。
- 切换至
MicroPython 积木模式。 - 点击左下角的
扩展按钮。 - 选择并加载
行空板 K10。

3.2 设置 SIoT 连接
在程序开始后,先完成网络连接和 MQTT 客户端的参数初始化。
| 设置项 | 填写内容 |
|---|---|
| WiFi名称 | 你的WiFi名称 |
| WiFi密码 | 你的WiFi密码 |
| 平台 | SIoT V2 |
| 服务器地址 | 实际 SIoT IP |
| 用户名 | siot |
| 密码 | dfrobot |
| 设置WiFi | 设置MQTT |
|---|---|
![]() |
![]() |
参考程序如下:

连接成功后,行空板 K10 屏幕上会出现类似“WIFI连接成功和MQTT连接成功”的提示。

3.3 项目一:上传温度数据到 SIoT
项目效果
在 MicroPython 积木模式下,行空板 K10 定时读取并发送温度至 SIoT:
| 数据 | Topic |
|---|---|
| 温度 | siot/k10_temp |
积木编写步骤
- 在
开始积木下方配置 Wi-Fi 和 MQTT 连接。 - 在屏幕上初始化并显示文字提示 "WIFI已连接"和"MQTT已连接"。
- 在
重复执行循环内,使用变量保存板载温度数值。 - 使用 MQTT 发布积木,将温度发布到
siot/k10_temp。 - 在屏幕上刷新显示当前的温度读数。
- 设置等待时间为 2 秒。
参考程序如下:

查看上传结果
运行项目后,在浏览器中登录 SIoT 后台,查看 siot/k10_temp 主题的数据记录,核对是否成功更新。

3.4 项目二:通过 SIoT 控制 RGB 灯
项目效果
在 SIoT Web 页面中向 siot/k10_led 发送指令,行空板 K10 根据指令控制板载 RGB 灯。发送 ON 控制 K10 的板载 RGB 灯点亮(绿色),发送 OFF 控制其关闭。
积木编写步骤
- 在
开始积木下方配置 Wi-Fi 和 MQTT 连接。 - 在屏幕上初始化并显示文字提示 "WIFI已连接"和"MQTT已连接"。
- 创建事件:“当收到主题 [siot/k10_led] 消息” 积木。
- 在事件块内判断消息内容:
- 若消息 =
ON:亮起板载 RGB 灯(绿色),并在屏幕更新状态。 - 若消息 =
OFF:关闭 RGB 灯,并在屏幕更新状态。
- 若消息 =
参考程序如下:

发送控制指令
在 SIoT 控制面板的 siot/k10_led 主题发送 ON,观察 K10 灯光是否点亮;发送 OFF 观察是否熄灭。

3.5 MicroPython 积木模式综合效果
可以将上传与接收集成在同一个积木工程中,代码参考逻辑组织如下:

运行效果:

4. MicroPython 代码模式
MicroPython 代码模式适合希望进一步理解底层通信、进行代码化和复杂系统扩展的学习者。
4.1 进入 MicroPython 代码模式
- 打开 Mind+,新建项目。
- 切换至
MicroPython 代码模式。 - 点击菜单栏的
选择主板按钮,下载和加载行空板K10。

4.2 MicroPython 连接 SIoT 的基本流程
使用 MicroPython 连接 SIoT 时,通常按以下步骤编写:
- 导入
WiFi和MqttClient库。 - 连接无线 Wi-Fi。
- 创建并配置
MqttClient实例,填写服务器地址、端口、账号和密码。 - 使用
connect()连接 SIoT 服务器。 - 使用
publish()上传传感器数据。 - 使用
received()绑定接收消息的回调函数,并订阅控制 Topic。
4.3 连接 SIoT 的示例
下面代码只完成 Wi-Fi 与 SIoT 连接,用于检查网络与 MQTT 参数设置是否正确。
from k10_base import WiFi, MqttClient # 导入网络与 MQTT 客户端库
import time # 导入时间库,用于延时控制
# --- 无线网络与 SIoT 连接配置 ---
WIFI_SSID = "dfrobotOffice" # Wi-Fi 热点名称
WIFI_PASSWORD = "dfrobot2011" # Wi-Fi 密码
SERVER = "192.168.1.183" # 运行 SIoT 软件的电脑局域网 IP
PORT = 1883 # MQTT 通信端口
CLIENT_ID = "" # MQTT 客户端唯一标识 ID,一般留空即可
IOT_USERNAME = "siot" # 默认 SIoT 登录用户名
IOT_PASSWORD = "dfrobot" # 默认 SIoT 登录密码
# 实例化网络与客户端对象
wifi = WiFi()
mqttclient = MqttClient()
# --- 1. 连接 Wi-Fi ---
wifi.connect(ssid=WIFI_SSID, psd=WIFI_PASSWORD, timeout=50000) # 连接 Wi-Fi 局域网
print("Wi-Fi 连接状态:", wifi.status()) # 在控制台打印 Wi-Fi 连通状态
# --- 2. 连接 SIoT MQTT ---
if wifi.status() == True or wifi.status() == 1:
mqttclient.connect(
server=SERVER,
port=PORT,
client_id=CLIENT_ID,
user=IOT_USERNAME,
psd=IOT_PASSWORD
) # 连接 SIoT MQTT 服务器
print("MQTT 连接状态:", mqttclient.connected()) # 在控制台打印 MQTT 连通状态
else:
print("Wi-Fi 未连通,无法连接 MQTT")
# --- 主循环维持运行 ---
while True:
time.sleep(1) # 休眠 1 秒,保持连接并降低 CPU 占用
当运行成功后,在终端区域会出现“Wi-Fi 连接状态: True”和“MQTT 连接状态: True”的提示。

重要代码说明:
| 代码 | 作用 |
|---|---|
WiFi() |
实例化 Wi-Fi 模块对象 |
MqttClient() |
实例化 MQTT 客户端对象 |
wifi.connect(...) |
连接 Wi-Fi 局域网 |
mqttclient.connect(...) |
连接 SIoT MQTT |
mqttclient.connected() |
返回 MQTT 连接状态 |
wifi.status() |
返回 Wi-Fi 连接状态 |
4.4 项目一:上传温度数据到 SIoT
下面代码读取板载温度传感器数据,并发送到 SIoT。
from k10_base import WiFi, MqttClient # 导入网络与 MQTT 客户端库
from unihiker_k10 import temp_humi, screen # 导入 K10 板载传感器与屏幕控制模块
import time # 导入时间库,用于控制延时与主循环频率
# --- 无线网络与 SIoT 连接配置 ---
WIFI_SSID = "dfrobotOffice" # Wi-Fi 热点名称
WIFI_PASSWORD = "dfrobot2011" # Wi-Fi 密码
SERVER = "192.168.1.183" # 运行 SIoT 软件的电脑局域网 IP
PORT = 1883 # MQTT 通信端口
CLIENT_ID = "" # MQTT 客户端唯一标识 ID,一般留空即可
IOT_USERNAME = "siot" # 默认 SIoT 登录用户名
IOT_PASSWORD = "dfrobot" # 默认 SIoT 登录密码
TEMP_TOPIC = "siot/k10_temp" # 发布温度数据的 MQTT 主题
# 实例化网络与客户端对象
wifi = WiFi()
mqttclient = MqttClient()
# --- 硬件驱动与界面初始化 ---
screen.init(dir=2) # 初始化 K10 屏幕(dir=2 为横屏显示)
screen.show_bg(color=0xFFFFFF) # 设置屏幕背景颜色为白色(0xFFFFFF)
# --- 1. 连接 Wi-Fi ---
wifi.connect(ssid=WIFI_SSID, psd=WIFI_PASSWORD, timeout=50000) # 连接 Wi-Fi 局域网
# --- 2. 连接 SIoT MQTT ---
mqttclient.connect(
server=SERVER,
port=PORT,
client_id=CLIENT_ID,
user=IOT_USERNAME,
psd=IOT_PASSWORD
) # 连接 SIoT MQTT 服务器
# --- 主循环:持续读取温度并上传 ---
while True:
temp = temp_humi.read_temp() # 读取板载传感器测得的摄氏温度值
# 发布数据到 SIoT
mqttclient.publish(topic=TEMP_TOPIC, content=str(temp)) # 向指定 Topic 发布数据
# 更新屏幕显示
screen.show_bg(color=0xFFFFFF) # 清屏(擦除上一次显示的旧文字)
screen.draw_text(text="实时温度: " + str(temp), x=10, y=20, font_size=24, color=0x0000FF) # 绘制最新温度文字(字号调至 24)
screen.show_draw() # 刷新屏幕显示
print("已上传温度:", temp) # 在控制台打印当前温度,便于本地调试
time.sleep(2) # 延时 2 秒,避免数据发送过快
运行项目后,在浏览器中登录 SIoT 后台,查看 siot/k10_temp 主题的数据记录,核对是否成功更新。

4.5 项目二:通过 SIoT 控制 RGB 灯
下面代码订阅 siot/k10_led,当收到 ON 时点亮板载 RGB 灯为绿色,收到 OFF 时关闭。
from k10_base import WiFi, MqttClient # 导入网络与 MQTT 客户端库
from unihiker_k10 import rgb, screen # 导入 K10 板载 RGB 灯与屏幕控制模块
import time # 导入时间库,用于延时控制
# --- 无线网络与 SIoT 连接配置 ---
WIFI_SSID = "dfrobotOffice" # Wi-Fi 热点名称
WIFI_PASSWORD = "dfrobot2011" # Wi-Fi 密码
SERVER = "192.168.1.183" # 运行 SIoT 软件的电脑局域网 IP
PORT = 1883 # MQTT 通信端口
CLIENT_ID = "" # MQTT 客户端唯一标识 ID,一般留空即可
IOT_USERNAME = "siot" # 默认 SIoT 登录用户名
IOT_PASSWORD = "dfrobot" # 默认 SIoT 登录密码
LED_TOPIC = "siot/k10_led" # 订阅 LED 控制指令的 MQTT 主题
# 实例化网络与客户端对象
wifi = WiFi()
mqttclient = MqttClient()
# --- 硬件驱动与界面初始化 ---
screen.init(dir=2) # 初始化 K10 屏幕(dir=2 为横屏显示)
screen.show_bg(color=0xFFFFFF) # 设置屏幕背景颜色为白色(0xFFFFFF)
# 屏幕绘制初始状态
screen.draw_text(text="LED灯状态:等待控制", x=0, y=20, font_size=24, color=0x0000FF)
screen.show_draw() # 刷新屏幕显示
# --- 1. 连接 Wi-Fi ---
wifi.connect(ssid=WIFI_SSID, psd=WIFI_PASSWORD, timeout=50000) # 连接 Wi-Fi 局域网
# --- 定义 MQTT 消息监听回调函数 ---
def led_callback():
msg = mqttclient.message(topic=LED_TOPIC) # 获取接收到的消息内容
if msg is None:
return
msg = str(msg).strip() # 解码并去除两端的空格与换行
print("收到控制指令:", msg)
# 根据不同的控制指令切换 RGB 灯亮灭并更新屏幕显示
if msg in ["ON", "on", "1", "开"]:
rgb.write(color=0x00FF00) # 板载 RGB 灯点亮为绿色
screen.show_bg(color=0xFFFFFF) # 清屏
screen.draw_text(text="LED灯状态:打开", x=0, y=20, font_size=24, color=0x00AA00) # 绿色字体显示“打开”
screen.show_draw() # 刷新屏幕显示
elif msg in ["OFF", "off", "0", "关"]:
rgb.clear() # 关闭板载 RGB 灯
screen.show_bg(color=0xFFFFFF) # 清屏
screen.draw_text(text="LED灯状态:关闭", x=0, y=20, font_size=24, color=0xFF0000) # 红色字体显示“关闭”
screen.show_draw() # 刷新屏幕显示
# --- 2. 连接 SIoT MQTT ---
mqttclient.connect(
server=SERVER,
port=PORT,
client_id=CLIENT_ID,
user=IOT_USERNAME,
psd=IOT_PASSWORD
) # 连接 SIoT MQTT 服务器
# 绑定消息接收回调函数并订阅主题
mqttclient.received(topic=LED_TOPIC, callback=led_callback)
# --- 主循环维持运行 ---
while True:
time.sleep(0.1) # 保持微小延时,维持程序运行,降低 CPU 占用
当运行成功后,在 SIoT Web 页面向 siot/k10_led 发送 ON 或 OFF 控制指令,你就能远程控制行空板 K10 上的 RGB 灯。

4.6 综合示例:温度上传 + RGB 控制
下面代码把上传与控制合并在一起。行空板 K10 边上传数据边响应云端控制。
from k10_base import WiFi, MqttClient # 导入网络与 MQTT 客户端库
from unihiker_k10 import temp_humi, rgb, screen # 导入 K10 板载传感器、RGB灯与屏幕控制模块
import time # 导入时间库,用于延时控制
# --- 无线网络与 SIoT 连接配置 ---
WIFI_SSID = "dfrobotOffice" # Wi-Fi 热点名称
WIFI_PASSWORD = "dfrobot2011" # Wi-Fi 密码
SERVER = "192.168.1.183" # 运行 SIoT 软件的电脑局域网 IP
PORT = 1883 # MQTT 通信端口
CLIENT_ID = "" # MQTT 客户端唯一标识 ID,一般留空即可
IOT_USERNAME = "siot" # 默认 SIoT 登录用户名
IOT_PASSWORD = "dfrobot" # 默认 SIoT 登录密码
TEMP_TOPIC = "siot/k10_temp" # 发布温度数据的 MQTT 主题
LED_TOPIC = "siot/k10_led" # 订阅 LED 控制指令 of MQTT 主题
# --- 全局状态变量(用于屏幕画面的统一渲染) ---
current_temp = "读取中..." # 缓存当前温度值
led_status = "等待控制" # 缓存当前 LED 状态
led_color = 0x0000FF # LED 状态文字的颜色(初始为蓝色 0x0000FF)
# 实例化网络与客户端对象
wifi = WiFi()
mqttclient = MqttClient()
# --- 屏幕画面统一刷新函数 ---
def update_screen():
screen.show_bg(color=0xFFFFFF) # 清空屏幕背景为白色
# 绘制第一行:实时温度
screen.draw_text(text="实时温度: " + str(current_temp) + " C", x=10, y=20, font_size=24, color=0x0000FF)
# 绘制第二行:LED 灯状态(动态色彩:打开显示绿色,关闭显示红色,等待显示蓝色)
screen.draw_text(text="LED灯状态:" + led_status, x=10, y=65, font_size=24, color=led_color)
screen.show_draw() # 刷新画布,将内容呈呈现屏幕上
# --- 硬件驱动与界面初始化 ---
screen.init(dir=2) # 初始化 K10 屏幕(dir=2 为横屏显示)
update_screen() # 绘制初始画面
# --- 1. 连接 Wi-Fi ---
wifi.connect(ssid=WIFI_SSID, psd=WIFI_PASSWORD, timeout=50000) # 连接 Wi-Fi 局域网
# --- 定义 MQTT 消息监听回调函数 ---
def led_callback():
global led_status, led_color # 声明使用全局变量
msg = mqttclient.message(topic=LED_TOPIC) # 获取接收到的消息
if msg is None:
return
msg = str(msg).strip() # 解码并去除两端的空格与换行
print("收到控制指令:", msg)
# 切换 RGB 灯状态并更新屏幕的全局变量
if msg in ["ON", "on", "1", "开"]:
rgb.write(color=0x00FF00) # 板载 RGB 灯点亮为绿色
led_status = "打开"
led_color = 0x00AA00 # 文字设为绿色
elif msg in ["OFF", "off", "0", "关"]:
rgb.clear() # 关闭板载 RGB 灯
led_status = "关闭"
led_color = 0xFF0000 # 文字设为红色
update_screen() # 立即更新屏幕画面
# --- 2. 连接 SIoT MQTT ---
mqttclient.connect(server=SERVER,port=PORT,client_id=CLIENT_ID,user=IOT_USERNAME,psd=IOT_PASSWORD
) # 连接 SIoT MQTT 服务器
# 绑定消息接收回调函数并订阅主题
mqttclient.received(topic=LED_TOPIC, callback=led_callback)
# --- 主循环:边上传数据,边等待回调响应 ---
while True:
current_temp = temp_humi.read_temp() # 读取板载传感器最新的摄氏温度值
# 发布温度数据到 SIoT 服务器
mqttclient.publish(topic=TEMP_TOPIC, content=str(current_temp))
print("已上传温度:", current_temp) # 在控制台打印当前温度值
update_screen() # 定时刷新屏幕画面显示最新温度
time.sleep(2) # 延时 2 秒,避免数据发送过快
如果程序运行正常,可以在 SIoT 中看到温度数据,同时也可以通过发送 ON、OFF 控制 RGB 灯。




